package com.springboot.mapper;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.springboot.entity.Product;
import com.springboot.vo.ProductDetailVO;
import com.springboot.vo.ProductWithCategoryVO;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 商品表 Mapper 接口
 *
 * @author zjb
 * @since 2025-10-26
 */
public interface ProductMapper extends BaseMapper<Product> {

    /**
     * 分页查询所有上架商品（带分类名称）
     *
     * @param page 分页参数
     * @param categoryId 分类id（非叶子分类将会查询子叶分类的商品）
     * @param search 搜索参数（商品名）
     * @return 商品分页数据（含分类名称）
     */
    IPage<ProductWithCategoryVO> selectAllOnShelfWithCategoryPage(IPage<ProductWithCategoryVO> page,
                                                                  @Param("status") Integer status,
                                                                  @Param("categoryId") Integer categoryId,
                                                                  @Param("search") String search,
                                                                  @Param("newProduct") Integer newProduct,
                                                                  @Param("categoryIds") List<Integer> categoryIds);
    
    /**
     * 根据商品ID查询商品详情
     * 
     * @param productId 商品ID
     * @return 商品详情VO
     */
    ProductDetailVO selectProductDetailById(@Param("productId") Integer productId);

}